.. _cesReadDword:

cesReadDword
============
--------------


SYNOPSYS
`````````````
.. code-block:: none

  t_i32 cesReadDword( 
        [in] t_i32 nNodeID, 
        [in] t_i32 nChannel,
        [in] t_i32 nNumBufSize,
        [in] t_ui32   aRetBuf,
        [out] t_i32  nNumRetBytes
    )

DESCRIPTION
`````````````

- 수신 버퍼로부터 Double Word (4 바이트) 단위로 데이터를 읽어옵니다.
- 버퍼 카운트를 Double Word 개수에 해당하는 바이트 수만큼 각각 감소 및 증가 시킵니다.


PARAMETER
`````````````
- nNetID : 원격 노드 ID

- nChannel : 채널 번호

- nNumBufSize :  Double Word(4 바이트) 단위의 데이터 개수를 설정합니다.

- aRetBuf : 

- nNumRetDwords :  1 개 이상의 Double Word 데이터



RETURN VALUE
`````````````

- 함수 수행 여부를 반환합니다.

+----------------+-----------+
| Value          | Meaning   |
+================+===========+
| 음수           | 수행 실패 |
+----------------+-----------+
| 0 (ceERR_NONE) | 수행 성공 |
+----------------+-----------+



EXAMPLE
`````````````

.. code-block:: cpp
 :linenos:


 #include "ceSDK.h"
 #include "ceSDKDef.h"
 long nSerialChNo = 0; // 시리얼 채널(Port) 번호
 DWORD adwData[5]; // DWORD 열 데이터 정보
 // 0 번 시리얼 포트에 대해 수신 버퍼로부터 5 DWORD 크기의 데이터 확인
 if ( cesReadDword ( nSerialChNo, 5, &adwData ) != ceERR_NONE )
 {
 OutputDebugString ( "cesReadDword has been failed" );
 }
 /* 전달 패킷 생성 */
 adwData[0] = '@';
 adwData[1] = 'A';
 adwData[2] = 'B';
 adwData[3] = 'C';
 abwData[4] = '!';
 if ( cesWriteDword ( nSerialChNo, 5, adwData) == ceERR_NONE )
 {
 cesCommit ( nSerialChNo );
 }